home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dprof.z / dprof
Text File  |  1998-10-20  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDPPPPRRRROOOOFFFF((((1111))))                                                              DDDDPPPPRRRROOOOFFFF((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddpppprrrrooooffff - a memory access profiling tool
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      dprof [----iiiittttiiiimmmmeeeerrrr [----mmmmssss nnnn]]
  13.      [----hhhhwwwwppppcccc [----ccccnnnnttttrrrr  _n] [----oooovvvvffffllll _n]]
  14.      [----ppppccccmmmmiiiinnnn _m_i_n] [----ppppccccmmmmaaaaxxxx _m_a_x]
  15.      [----ddddaaaammmmiiiinnnn mmmmiiiinnnn] [----ddddaaaammmmaaaaxxxx mmmmaaaaxxxx]
  16.      [----ppppaaaaggggeeee][----hhhheeeexxxx][----oooocccctttt][----qqqquuuuaaaadddd][----ddddoooouuuubbbblllleeee][----iiiinnnntttt]
  17.      [----oooouuuutttt _f_i_l_e] [----ppppoooouuuutttt _d_p_l_a_c_e__f_i_l_e] [----tttthhhhrrrreeeeaaaaddddssss____ppppeeeerrrr____mmmmeeeemmmm _n]
  18.      [----vvvveeeerrrrbbbboooosssseeee] _c_o_m_m_a_n_d
  19.  
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The given _c_o_m_m_a_n_d is executed and memory accesses are sampled; after
  23.      completion, _d_p_r_o_f prepares a histogram of memory accesses.  Histograms
  24.      are computed for each thread of multi-threaded applications that utilize
  25.      sssspppprrrroooocccc(2).
  26.  
  27.  
  28.  
  29.  
  30. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  31.      ----iiiittttiiiimmmmeeeerrrr
  32.           Use the interval timer as a sampling trigger.
  33.  
  34.      ----mmmmssss _n
  35.           Trigger every _n milliseconds. (default is 100)
  36.  
  37.      ----hhhhwwwwppppcccc
  38.           Use R10000 hardware event counter overflow as a sampling trigger.
  39.  
  40.      ----ccccnnnnttttrrrr _n
  41.           Use R10000 hardware event counter _n as the event trigger.  Default
  42.           is number of cycles; event 0.
  43.  
  44.      ----oooovvvvffffllll _n
  45.           Trigger after _n events have occurred.  Default is 10,000.
  46.  
  47.      ----ppppccccmmmmiiiinnnn _m_i_n
  48.           Ignore events that have a program counter smaller than _m_i_n.
  49.  
  50.      ----ppppccccmmmmaaaaxxxx _m_a_x
  51.           Ignore events that have a program counter larger than _m_a_x.
  52.  
  53.      ----ddddaaaammmmiiiinnnn _m_i_n
  54.           Ignore memory operations that have a virtual addresses smaller than
  55.           _m_i_n.
  56.  
  57.      ----ddddaaaammmmaaaaxxxx _m_a_x
  58.           Ignore memory operations that have a virtual addresses larger than
  59.           _m_a_x.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDPPPPRRRROOOOFFFF((((1111))))                                                              DDDDPPPPRRRROOOOFFFF((((1111))))
  71.  
  72.  
  73.  
  74.      ----ppppaaaaggggeeee
  75.           Use pagesize (16k bytes) granularity for memory access sampling.
  76.  
  77.      ----lllliiiinnnneeee
  78.           Use cache linesize (128 bytes) size granularity for memory access
  79.           sampling.
  80.  
  81.      ----hhhheeeexxxx Use hex (64 bytes) size granularity for memory access sampling.
  82.  
  83.      ----oooocccctttt Use oct (32 bytes) size granularity for memory access sampling.
  84.  
  85.      ----qqqquuuuaaaadddd
  86.           Use quad (16 bytes) size granularity for memory access sampling.
  87.  
  88.      ----ddddoooouuuubbbblllleeee
  89.           Use double (8 bytes) size granularity for memory access sampling.
  90.  
  91.      ----iiiinnnntttt Use int (4 bytes) size granularity for memory access sampling.
  92.  
  93.      ----ssssiiiigggguuuussssrrrr
  94.           Sampling is not started until SIGUSR1 is received. Further SIGUSR1
  95.           signals toggle sampling off and on.
  96.  
  97.      ----oooouuuutttt _f_i_l_e
  98.           Output is sent to _f_i_l_e rather than standard output.
  99.  
  100.      ----ppppoooouuuutttt _d_p_l_a_c_e__f_i_l_e
  101.           Placement information suitable for ddddppppllllaaaacccceeee(1) is written to
  102.           _d_p_l_a_c_e__f_i_l_e.
  103.  
  104.      [----tttthhhhrrrreeeeaaaaddddssss____ppppeeeerrrr____mmmmeeeemmmm _n]
  105.           When building _d_p_l_a_c_e__f_i_l_e a thread assignment that assumes _n threads
  106.           per memory is assumed.
  107.  
  108. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  109.      To collect a memory access histogram from a program called a.out that
  110.      would normally be run by
  111.         % a.out < in > out
  112.      and place the resuls in a file called _h_i_s_t_o_g_r_a_m one would simply
  113.         % dprof -out histogram a.out < in > out .
  114.  
  115.  
  116. DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  117.      ddddpppprrrrooooffff options ----hhhhwwwwppppcccc, ----ccccnnnnttttrrrr _n and ----oooovvvvffffllll _n only apply to R10000 based
  118.      systems.
  119.  
  120.  
  121. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  122.      ddddppppllllaaaacccceeee(1), sssspppprrrroooocccc(2), rrrr11110000kkkk____ccccoooouuuunnnntttteeeerrrrssss(5)
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.